3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Redistributing 3D RSX

If you are planning to ship 3D RSX with your application, please consult the release notes on licensing issues.

The following topics describe the files and process you need to follow to redistribute 3D RSX with your application.


Run-time Installation Files

The 3D RSX SDK installation puts the files you need for redistributing run-time 3D RSX in your RSX3D\SAMSETUP\DISK1 directory. Copy files from this directory to your delivery medium and add instructions to your application's InstallShield 3.0 script.

The 3D RSX InstallShield run-time installation consists of the following files:

rsx.ins
InstallShield script to install RSX.
 
rsx.z
Core files for 3D RSX.
 
rsxredis.z
Required redistributable files for 3D RSX. (These files are optional only if you are already shipping msvcrt40.dll with your application.)

The 3D RSX run-time install expands rsx.z and installs these files on your end user's system:

rsx.dll
3D RSX audio library.
 
rsxdata.dll
3D RSX audio data library.
 
aaudio.dll
Support for the RSX 1.0 API.
 
RSXConfg.exe
RSX Configuration and Diagnostic Utility
 
RSXConfg.hlp
Configuration Utility help file.
 
button.mid
MIDI test file for Configuration Utility.
 
RSXTool.exe
Tray applet for easy switching of audio peripherals.
 
RSXTool.hlp
Help file for tray applet.

The install may also install file(s) from rsxredis.z into the WINDOWS\SYSTEM directory:

msvcrt40.dll
C run-time library.

NOTE. If you are shipping the same version (or a newer version) of msvcrt40.dll with your application, you can decrease the size of the 3D RSX installation by not including the file: rsxredis.z.

The 3D RSX run-time install creates a folder called Intel 3D RSX with icons and shortcuts to the following:

RSXConfg.exe
RSX configuration/diagnostic utility.
 
Uninst.exe
Uninstall executable. This executable resides in the WINDOWS\SYSTEM directory. The run-time install only adds the RSX icon on systems running Windows NT, version 3.51.

Installing the Run-time Files with InstallShield

To install the 3D RSX run-time files, you must use InstallShield 3.0. The 3D RSX run-time components always install to DRIVE:\RSX2 where DRIVE is the drive letter where Windows is installed.

Add the following lines to your application's InstallShield script to install 3D RSX:

if(DoInstall(rsx.ins, "SILENT", WAIT) != 0) then
MessageBox("An error occurred trying to begin the RSX installation",
WARNING);endif;

The first parameter in the DoInstall function, rsx.ins, is the filename of the 3D RSX install script.

The second parameter in the DoInstall function, "SILENT" represents the command-line options to use for launching the RSX run-time install. The SILENT option suppresses display of dialog boxes or splash screens. The third parameter, WAIT, halts your installation program until the 3D RSX installation finishes.

NOTE. Calling the install script, as described above, is different from using the InstallShield Silent mode specified with -s. Our silent mode offers the advantage of displaying error messages in the event of a failure.

If you do not invoke the 3D RSX run-time install with the SILENT option, the installation uses its own user interface.

IMPORTANT: If you use an InstallShield packing list file (setup.pkg) in your installation, ensure that the source file (setup.lst) includes the files rsx.z and rsxredis.z (if you are using this file).


Installing the Run-time Files without using InstallShield

If you do not wish to use the 3D RSX Installshield runtime installation you may use our standalone 3D RSX runtime installation program. The two (2) files required for this installation can be found in the \rtsetup directory under the directory you installed the RSX SDK into. The install program is rsxsetup.exe and the RSX uninstall program is rsxunins.exe.

To install 3D RSX:

From the installation program for your application simply copy the following files to the user's local hard disk - preferably into their TEMP directory.

  1. rsxsetup.exe
  2. rsxunins.exe
  3. rsx.dll
  4. aaudio.dll
  5. rsxdata.dll
  6. rsxtool.exe
  7. rsxtool.hlp
  8. msvcrt40.dll (Optional if you are already installing this file as part of the installation of your application)
  9. rsxconfg.exe
  10. rsxconfg.hlp
  11. button.mid
  12. license.txt

You may wish to compress these files in your installation and then decompress them onto the user's local hard drive. After the files have been copied to the user's local hard drive run the program rsxsetup.exe (the copy residing in the user's TEMP directory. This program will install 3D RSX and it will also clean up all of the above files (1-12) from the users's TEMP directory.

 

3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved